home *** CD-ROM | disk | other *** search
/ SGI Hot Mix 8 / Hot Mix 8.iso / .all / demos / Imagicians / USER_INSTRUCTIONS (.txt) < prev   
Text File  |  1994-06-22  |  13KB  |  411 lines
  1. ***************************************************************
  2. FILE:    ./USER_INSTRUCTIONS        DATE:    02 June 94 KBE
  3.  
  4.     INDEX
  5.     -----
  6.  
  7.  1) Section I    - Outlines the contents of this directory.
  8.  
  9.  2) Section II    - Instructions for running CHANCE'S ART.
  10.  
  11.  3) Section III    - A brief overview of CHANCE'S ART.
  12.  
  13.  4) Section IV    - How to modify CHANCE'S ART to allow VERY
  14.           LONG FILM STRIPS to be generated.
  15.  
  16. ***************************************************************
  17.  
  18. I Directory Contents:
  19.   ------------------
  20.  
  21.      1) README
  22.  
  23.     An overview of the complete directory tree structure.
  24.  
  25.      2) ca                         
  26.     ca.bw
  27.     ca.Big_Icons_Not_For_Demo 
  28.     ca.default
  29.     ca.beige                   
  30.     ca.tan
  31.     ca.blue                    
  32.     ca.teal
  33.     ca.x
  34.  
  35.     These are command scripts, any one of which will run
  36.     the CHANCE'S ART package (contained in ./bin). These
  37.     files each reference their own resource file in the
  38.     ./config/res directory. The resource files differ in
  39.     only one way: they each present a slightly different
  40.     GUI appearance, in which the resource file colors are
  41.     changed. Thus the resource file ./config/res/Imf.teal
  42.     is used by the command script ./ca.teal. The ca.x res
  43.     has a larger Photo Mode color palette than the others.
  44.  
  45.     To get going quickly, just use the ca command script
  46.     and only install your PASSWORD in the resource file:
  47.  
  48.         ./config/res/Imf.default
  49.  
  50.      4) See README in this directory for an overview of the
  51.     file directory structure and contents.
  52.  
  53. ***************************************************************
  54.  
  55. II Execution Instructions:
  56.    ----------------------
  57.  
  58.      1) To run the package, you will need a password. There are
  59.     several classes of machine specific password available:
  60.  
  61.         - a free 30-day demo password, in which some
  62.           functionality has been disabled;
  63.  
  64.         - a full functionality, 30-day trial license, 
  65.           for which there is a modest license fee
  66.           (100% deductible from the full price);
  67.  
  68.         - an open-ended, full functionality license.
  69.  
  70.      2)    To obtain a password, you will need to provide IAI with
  71.     a machine ID number. This is easily obtained by simply
  72.     attempting to run the command script ca from this
  73.     directory. It will, after several seconds, fail and ask
  74.     you to get in touch with IAI. It will also display
  75.     your machine's ID, a hex string of 32 digits, grouped
  76.     into 4 blocks of 8-digits each.
  77.  
  78.      3)    When you receive your password (PASSW) from IAI, you
  79.     will need to install it in at least one of the resource
  80.     files in the ./config/res directory. We suggest you use
  81.     the Imf.default resource file. Later, feel free to
  82.     insert the password in the other resource files and try 
  83.     the other command scripts. Open Imf.default with your
  84.     favorite editor (jot is quite up to this trivial task)
  85.     and change the *password parameter, at the start of the
  86.     file, from:
  87.  
  88.     *password:          12345678901234567879012
  89.  
  90.     to:
  91.  
  92.     *password:          PASSW (your 22 digit password)
  93.  
  94.     Exit the editing session, saving your changes, and cd to
  95.     the CHANCE'S ART root directory.
  96.  
  97.     4)    The iai binary file is in the bin directory:
  98.  
  99.         bin/iai
  100.  
  101.     5)    Run CHANCE'S ART by either:
  102.  
  103.          a) Typing into the root of the CHANCE'S ART
  104.         directory tree structure, in a shell window:
  105.  
  106.         ca
  107.  
  108.         (Which is the same as ca.default)
  109.  
  110.          b) Opening a WorkSpace directory window into the
  111.         root of the CHANCE'S ART directory tree
  112.         structure and using the mouse to double click
  113.         on the ca command script (or on ca.default).
  114.  
  115.        5) From this point on, you can obtain user help from:
  116.  
  117.          a) the ONLINE HELP text windows, which are
  118.         available from the Help buttons in the various
  119.         GUI windows and dialog boxes;
  120.  
  121.          b) the hard copy USER MANUAL, shipped with 30-day
  122.         or unlimited licenses;
  123.  
  124.          c) the "Package Overview" section below, which
  125.         summarizes a few basic ideas that might prove
  126.         helpful in getting you started.
  127.  
  128. ***************************************************************
  129.  
  130. III Package Overview:
  131.     ----------------
  132.  
  133.  1) The package opens by presenting you with a Work Window.
  134.     There are two classes of windows in CA:
  135.  
  136.     - Work Windows (WW), used for generating images;
  137.     
  138.     - Film Strip Windows (FS), used for storing and
  139.       retrieving images. A Film Strip can contain one
  140.       or more "frames". The metaphor of a film strip allows
  141.       storage of unrelated images (a slide collection) or
  142.       of frames from an animated sequence (a movie clip).
  143.  
  144.     You are free to have many Work Windows and Film Strips open
  145.     simultaneously, limited only by RAM (swapping overheads) and
  146.     processing power (multiple images computed at once will
  147.     generate proportionally slower).
  148.  
  149.     A new WORK WINDOW can be opened at any time:
  150.  
  151.     - from a Film Strip Window:
  152.  
  153.       "Create Work Window" from the "File" PullDowm Menu;
  154.  
  155.         - from a Work Window:
  156.  
  157.       "Create Work Window" from the "Windows" PullDowm Menu;
  158.  
  159.     A new FILM STRIP WINDOW can be opened at any time:
  160.  
  161.     - from a Film Strip Window:
  162.  
  163.       "Create Film Strip..." from the "File" PullDowm Menu;
  164.  
  165.         - from a Work Window:
  166.  
  167.       "Create Film Strip..." from the "Windows" PullDowm
  168.       Menu;
  169.  
  170.  2) Work Windows. Two types of Dialog Box offer the primary
  171.     means to control the image in a Work Window. These are
  172.     obtained from the "Edit" PullDown Menu
  173.  
  174.     - "Equation..."
  175.  
  176.       Equation Dialog Box (there is one for each open 
  177.       Work Window). This is used to choose an equation 
  178.       and then select the various control parameters;
  179.  
  180.     - "Colors..."
  181.  
  182.       Color Editing Dialog Box (there is one for each  
  183.       open Work Window). This is used to edit an image's
  184.       colors, either through the color map or by actually
  185.       changing pixel values in an image.
  186.  
  187.  3) Film Strip Windows. 
  188.  
  189.     - Playback Windows (one for each open Film Strip),
  190.       used as a kind of virtual video player, to enable
  191.       the frames in a Film Strip to be played back as
  192.       a movie. There are controls for playback rate and
  193.       direction, as well as image size.
  194.  
  195.     - Interpolation for animation is performed in several
  196.       steps, using commands in the "Animation" PullDown
  197.       Menu:
  198.  
  199.       a) "Create Interpolation..." brings up a Dialog Box
  200.          which lets you select:
  201.  
  202.           - the number of frames to interpolate
  203.         between the selected "initial Key Frame"
  204.         (outlined in red) and the "final Key Frame";
  205.  
  206.           -    the number of Repeat Frames (usually 1);
  207.  
  208.           -    the Type of interpolation (5 Types are
  209.         currently available and the default is
  210.         Linear interpolation).
  211.  
  212.       b) "Edit Interpolation..." simply re-opens Dialog Box
  213.          (a) at any later time.
  214.  
  215.       c) "Expand Interpolation..." opens a new Film Strip
  216.          Window into which the interpolated icons will be
  217.          placed as they are computed. In the DEMO version
  218.          of the package, the ability to recompute a strip
  219.          of icons as arbitrarily large images is disabled.
  220.  
  221.  4) The number of possible images that CHANCE'S ART can produce
  222.     is unlimited. Since some of the infinite number of possible
  223.     images are more aesthetically interesting than others, a
  224.     database of possible images has been created to quickly get
  225.     you started on your explorations. This database consists of
  226.     a set of 19 image catalogs stored as Film Strips pairs in
  227.     the directory structure:
  228.  
  229.     ./catalogs
  230.     ./catalogs/EQN_01
  231.     .
  232.     .
  233.     .
  234.     ./catalogs/EQN_19
  235.  
  236.     In any of these 19 directories there will be two Film Strips,
  237.     for example, in ./catalogs/EQN_07 there are two film strips
  238.     that can be accessed from the "Load Film Strip..." command in
  239.     the "Windows" PullDown Menu of any Work Window or from the
  240.     "Load Film Strip..." command in the "File" PullDown Menu of
  241.     any Film Strip Window:
  242.  
  243.     ./catalogs/EQN_07/EQN_7D.fs
  244.     ./catalogs/EQN_07/EQN_7M.fs
  245.  
  246.     To get any image icon in a Film Strip to compute in a Work
  247.     Window, just select it with the MIDDLEMOUSE button and
  248.     Drag & Drop it from the Film Strip to the selected Work
  249.     Window. Open an "Equation..." Dialog Box to change the
  250.     geometry or parameters of the image; open a "Colors..."
  251.     Dialog Box to edit the colors. In the DEMO version, the
  252.     maximum size of an image is limited to 640 x 480 pixels.
  253.  
  254.  NOTE:
  255.  ----
  256.     Be careful to specify the full filepath when you perform
  257.     a "Save As..." command under the File PullDown Menu in
  258.     a Film Strip, otherwise your Film Strip files will all
  259.     end up in the directory from which you launched the
  260.     application! This, of course, does not apply to DEMO
  261.     versions, which cannot Save a Film Strip.
  262.  
  263.  4) To exercise all the capabilities of CHANCE'S ART, you 
  264.     will require a FULL (NON-DEMO) version of the package.
  265.     This will provide the following additional features:
  266.  
  267.     - Save command for Film Strips;
  268.  
  269.     - computation of images and movie sequences at 
  270.       resolutions as high as 10,240 x 8,192;
  271.  
  272.     - preset film & video aspect ratios;
  273.  
  274.     Purchasers of the Unlimited License will also receive a
  275.     user manual and a tape with a much larger image data base.
  276.     The latter contains over 1,500 precomputed starting points
  277.     for exploring the infinite variety of images that can be
  278.     created using CHANCE'S ART!
  279.  
  280.  5) Future releases will contain enhancements, several of
  281.     which are directed towards textile applications, such as:
  282.  
  283.     - repeat pattern capability built-in (at present, this
  284.       can be done using scripts built on 4Dgifts routines,
  285.       ipaste, snapshot, etc).
  286.  
  287.     - additional mathematical controls and new algorithms;
  288.  
  289.     - use of 8 and 12 bit color spaces for color editing,
  290.       for instantaneous, single-hue changes via the color
  291.       map;
  292.  
  293.     - silk-screen simulation previewing.
  294.  
  295. ***************************************************************
  296.  
  297. IV LIMITS TO THE MAXIMUM NUMBER OF OPEN GL WINDOWS
  298.    -----------------------------------------------
  299.  
  300.  This is the same information as can be found in the Help Pulldown 
  301.  Menu in any Film Strip Window.
  302.  
  303.      1) Limits on the Maximum Number of Windows
  304.     ---------------------------------------
  305.  
  306.     The default limit to the number of GL Windows which can
  307.     be opened at once is currently set in the Resource file,
  308.     in /usr/tmp/ca/config/res/Imf.default, to 118. Due to the
  309.     ease with which recent  SGI models can exceed this value,
  310.     the next release will remove this limitation altogether.
  311.     For this release, there are several ways to increase this
  312.     limit, given below in 4.2.
  313.  
  314.     Be aware that in this release, if you run MULTIPLE instances
  315.     of CHANCE'S ART simultaneously, when one instance attempts
  316.     to open more GL windows (typically, by creating new Film
  317.     Strip frames), if the total number of GL Windows open by ALL
  318.     GL applications exceeds the current system limit, that
  319.     instance will simply abort. The solution, if you are
  320.     displaying over 100 frames in your open Film Strip Windows,
  321.     is to only have a single instance of CHANCE'S ART open. A
  322.     single running copy will correctly estimate when you are
  323.     near the limit and warn you with a non-fatal message.
  324.  
  325.  
  326.      2)    Changing the Maximum Number of Windows
  327.     --------------------------------------
  328.  
  329.     Background
  330.     ----------
  331.  
  332.     SGI sets a parameter in the system  which limits the number
  333.     of GL windows that can be open at a given moment. This value
  334.     varies across platforms and across the various releases of
  335.     IRIX. It is typically either set to 128 or 256. Accordingly,
  336.     CHANCE'S ART currently assumes a conservative value of 128
  337.     and sets the limit to be 118 (to allow for a few other GL
  338.     applications to have open windows).
  339.  
  340.     To find out what the actual limits are on your machine, set
  341.     yourself up as the super user and look for a system file
  342.     called "rrm". The pathname varies from system to system,
  343.     some possible locations being: 
  344.  
  345.         /usr/sysgen/master.d/rrm
  346.         /usr/var/sysgen/master.d/rrm
  347.         /var/sysgen/master.d/rrm
  348.               
  349.     Use the find command ("find / -name rrm -print") to locate
  350.     your copy of "rrm". If you cat this file, you will find that
  351.     the rrm_maxrn parameter is defined to be either 128 or 256
  352.     on your system:
  353.  
  354.         #define rrm_maxrn 128
  355.         or
  356.         #define rrm_maxrn 256
  357.  
  358.     If it is 128, then you cannot use the "Resource File" fix,
  359.     in Section 4.2.1 below, to increase your GL windows limit;
  360.     in this case, look at Section 4.2.2 below.
  361.  
  362.  
  363.      a) Changing your Resource File GL WINDOWS LIMIT
  364.     --------------------------------------------
  365.  
  366.     If the value of rrm_maxrn is 256, then you can more than
  367.     double your Open Windows limit simply by changing the
  368.     parameter:
  369.  
  370.         *maxNumGLwindows
  371.  
  372.     in the resource file "/usr/tmp/ca/config/res/Imf.default",
  373.     from 118 to 146.
  374.  
  375.  
  376.      b) Changing your System's Internal GL WINDOWS LIMIT
  377.     ------------------------------------------------
  378.  
  379.     If the value of rrm_maxrn is 128, OR if you need to open
  380.     MORE than 246 frames at one time, then you must reset the
  381.     system parameter rrm_maxrn itself. This entails FOUR steps:
  382.  
  383.          1)    Edit the parameter rrm_maxrn in the line
  384.  
  385.             #define rrm_maxrn 128    /* or 256 */
  386.  
  387.         from 128 (or 256) to 256 (or whatever you deem
  388.         appropriate). To do so will require superuser
  389.         privileges.
  390.  
  391.          2)    From the superuser account, execute the autoconfig
  392.         command to recompile the Kernel:
  393.  
  394.             autoconfig -vf
  395.  
  396.              3)    When (2) is complete, reboot the system to pick up
  397.         the new value you have just installed.
  398.  
  399.          4)    Edit your CHANCE'S ART Resource file(s) and change
  400.         the parameter
  401.  
  402.             *maxNumGLwindows
  403.  
  404.         from 118 to 246 (or to a number at least 10 less
  405.         than the value that you have just installed in
  406.         rrm_maxrn).
  407.  
  408.     You should now be back in business!
  409.  
  410. ***************************************************************
  411.